PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Appearance Manager >

Programming With the Appearance Manager

GetTheme

Obtains a collection containing data describing the current theme.

pascal OSStatus GetTheme (
                     Collection ioCollection);
ioCollection
A value of type Collection . Pass a reference to a collection object, such as that created by calling the Collection Manager function NewCollection . On return, the collection contains data describing attributes of the current theme. See Inside Macintosh: QuickDraw GX Environment and Utilities for a description of NewCollection .
function result
A result code; see Result Codes .
DISCUSSION

The GetTheme function obtains a collection containing a copy of the data for the current theme. The theme data is in the form of collection items, each corresponding to an attribute of the theme. For a given theme, the actual number of collection items may vary, depending upon how fully the theme's attributes are specified. See Theme Collection Tags for descriptions of the possible theme collection items.

Your application can use theme collection tags, along with various Collection Manager functions, to access the data in the collection.

VERSION NOTES

Available with Appearance Manager 1.1 and later.

SEE ALSO

The function SetTheme .

© 1999 Apple Computer, Inc. – (Last Updated 29 April 99)